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CLAIMS : 

What is claimed is: 

5 1. A method comprising: 

receiving a designation of a particular portion of a 
body of source code; 

receiving a designation of an association of the 
particular portion of the body of source code with 
10 commentary related to the particular portion of the body 
of source code; 

receiving a designation of a set of intended readers 
of the commentary; and 

making the commentary and the associated particular 
15 portion of the body of source code accessible to only the 
set of intended readers. 

2. The method of claim 1, wherein the set of intended 
readers is designated by a user's selecting the set of 

20 intended readers from a set of potential intended 
readers, and wherein the set of potential intended 
readers is acquired by accessing a directory service. 

3. The method of claim 1, further comprising: 

25 receiving a designation of a particular time period 

during which the commentary will be available, wherein 
the commentary and associated particular portion of the 
body of source code are accessible to the set of intended 
readers during the particular time period. 
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4. The method of claim 1, further comprising: 
sending a notification to at least a subset of the 

set of intended readers to notify the at least a subset 
of the set of intended readers that the commentary is 
5 available. 

5. The method of claim 4, wherein the notification 
includes copies of the commentary and the particular 
portion of the body of source code. 

10 

6. The method of claim 4, wherein the notification is 
sent to the at least a subset of the set of intended 
readers via electronic mail. 

15 7. The method of claim 1, wherein the designation of an 
association of the particular portion of the body of 
source code with commentary related to the particular 
portion of the body of source code is represented in the 
form of at least one tag in a markup language, 

20 wherein the at least one tag is embedded within the 

body of source code. 

8. The method of claim 1, further comprising: 
generating, from the body of source code, a second 

25 body of source code that is capable of being compiled by 
a compiler. 

9. The method of claim 1, further comprising: 
formatting the commentary and the particular portion 

30 of the body of source code for display to a user. 
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10. The method of claim 1, wherein the particular 
portion of the body of source code is one of a 
subroutine, a line of code, a variable, an identifier, 

5 and a source code comment. 

11. The method of claim 1, wherein the commentary and 
the body of source code are recorded within a 
configuration management system, and 

10 wherein the commentary is made available to the set 

of intended readers by presenting the commentary along 
with the body of source code in response to a checking- 
out of the body of source code by one of the set of 
intended readers. 

15. 

12. The method of claim 1, wherein the method is 
executed in an integrated development environment. 

13. The method of claim 1, wherein the method executed 
20 from a program . having a command-line interface. 

14. A computer program product in a computer-readable 

medium comprising functional descriptive material that, 

j 

when executed by a computer, enables the computer to 
25 perform particular acts, the computer program product 
including: 

first functional descriptive material for receiving 
a designation of a particular portion of a body of source 
code; 
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second functional descriptive material for receiving 
a designation of an association of the particular portion 
of the body of source code with commentary related to the 
particular portion of the body of source code; 
5 third functional descriptive material for receiving 

a designation of a set of intended readers of the 
commentary; and 

fourth functional descriptive material for making 
the commentary and the associated particular portion of 
10 the body of source code accessible to only the set of 
intended readers. 

15. The computer program product of claim 15, wherein 
the set of intended readers is designated by a user's 
15 selecting the set of intended readers from a set of 
potential intended readers, and wherein the set of 
potential intended readers is acquired by accessing a 
directory service . 

20 16. The computer program product of claim 14, comprising 
additional functional descriptive material that, when 
executed by the computer, enables the computer to perform 
additional acts including: 

receiving a designation of a particular time period 

25 during which the commentary will be available, wherein 
the commentary and associated particular portion of the 
body of source code are accessible to the set of intended 
readers during the particular time period. 
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17. The computer program product of claim 14, comprising 
additional functional descriptive material that, when 
executed by the computer, enables the computer to perform 
additional acts including: 
5 sending a notification to at least a subset of the 

set of intended readers to notify the at least a subset 
of the set of intended readers that the commentary is 
available . 

10 18. The computer program product of claim 17, wherein 
the notification includes copies of the commentary and 
the particular portion of the body of source code. 

19. The computer program product of claim 17, wherein 
15 the notification is sent to the at least a subset of the 

set of intended readers via electronic mail. 

20. The computer program product of claim 14, wherein 
the designation of an association of the particular 

20 portion of the body of source code with commentary 

related to the particular portion of the body of source 
code is represented in the form of at least one tag in a 
markup language, 

wherein the at least one tag is embedded within the 

25 body of source code. 

21. The computer program product of claim 14, comprising 
additional functional descriptive material that, when 
executed by the computer, enables the computer to perform 

30 additional acts including: 
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generating, from the body of source code, a second 
body of source code that is capable of being compiled by 
a compiler. 

22. The computer program product of claim 14, comprising 
additional functional descriptive material that, when 
executed by the computer, enables the computer to perform 
additional acts including: 

formatting the commentary and the particular portion 
of the body of source code for display to a user. 

23. The computer program product of claim 14, wherein 
the particular portion of the body of source code is one 
of a subroutine, a line of code, a variable, an 
identifier, and a source code comment. 

24. The computer program product of claim 14, wherein 
the commentary and the body of source code are recorded 
within a configuration management system, and 

wherein the commentary is made available to the set 
of intended readers by presenting the commentary along 
with the body of source code in response to a checking- 
out of the body of source code by one of the set of 
intended readers. 

25. The computer program product of claim 14, wherein 
the computer program product forms an integrated 
development environment . 
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26. The computer program product of claim 14, wherein 
the computer program product executed from a program 
having a command-line interface. 

5 27. A data processing system comprising: 

first receiving means for receiving a designation of 
a particular portion of a body of source code; 

second receiving means for receiving a designation 
of an association of the particular portion of the body 
10 of source code with commentary related to the particular 
portion of the body of source code; 

third receiving means for receiving a designation of 
a set of intended readers of the commentary; and 

making means for making the commentary and the 
15 associated particular portion of the body of source code 
accessible to only the set of intended readers. 

28. The data processing system of claim 27, wherein the 
set of intended readers is designated by a user's 
20 selecting the set of intended readers from a set of 
potential intended readers, and wherein the set of 
potential intended readers is acquired by accessing a 
directory service. 

25 29. The data processing system of claim 27, wherein the 
commentary and the body of source code are recorded 
within a configuration management system, and 
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wherein the commentary is made available to the set 
of intended readers by presenting the commentary along 
with the body of source code in response to a checking- 
out of the body of source code by one of the set of 
5 intended readers. 



